docs/development/Building in Gitpod.md

   1 # Building in Gitpod
   2
   3 Gitpod offers an online build environment for building INAV targets.
   4 ## Setting up the environment and building targets
   5
   6 1.  Go to https://gitpod.io/new
   7 1.  Paste `https://github.com/iNavFlight/inav/tree/[version]` into the field called "Select a repository".
   8 1.  Ensure that you substitute [version] (e.g. 7.1.0) with the version number of INAV that you want to build.
   9 1.  Cick on the link that shows in the drop down and Gitpod will atomatically selects the adequate Editor and Browser.
  10 1.  Leave the other fields as default and click "Continue". Your build environment will be created.
  11 1.  At the bottom of the page, you will see a command line. Type `make [TARGET]` and wait for the target to be built.
  12 1.  Once the build has finished, navigate to the build folder using `cd build`.
  13 1.  Once in the folder, run `objcopy -O ihex -R .eeprom [TARGET].elf [TARGET].hex` to convert the `.elf` file to a `.hex` file.
  14 1.  Your new target `.hex` binary will be located in a folder called `bin`, which can be found at the top left of the page.
  15
  16
  17 NOTE: You can use this method to build your forks as well. Just paste in the link to your fork and follow the rest of the steps.
  18
  19 You are done!